The Mousetrap 
For HTML Designers 

1. Audience and Scope 

This guide is for those familiar with HTML but not with SML or JavaScript It will allow 
taking an existing mousetrap and modifying it so it can be applied to a different site. 

2. Operation 

The first two sections of The Mousetrap Programmer 's Guide can be read by a non- 
programmers for a description of the mousetrap mechanism. "The Mousetrap Effect" 
describes the action of the mousetrap from a user's point of view and "Operation 
Overview" discusses the sequence of events which occur when the browser's back button 
is pressed or a link is clicked. Also, check the "Mousetrap Flow Drawing" on page 1 6 to 
see how a mousetraps flow works. 

3. Mousetraping In A Nutshell 

In a nutshell, to apply the mousetrap to a non-mousetrap sales site, do the following: 

1 . Copy & rename the necessary files (section 7). 

2. Make sure the ..._tail.htm file copied from above has the proper directory for the 
legal section (see end of section 6). 

3. Insert the proper file names in the frameset page (section 5). 

4. Copy the SML at the very top of the page and JavaScript between the </title> and 
</head> from parallel pages in a mousetrap (for example, copy the SML and 
JavaScript from the Sex Museum softsales page to the new softsales page. 

5. Make sure all links in parallel pages have the JavaScript (onCIick, onMouseOver, 
onMouseOut) and SML tags (including the feeders on the links to the registration 
pages). 

6. Copy the SML conditional for the button/submit-button on the registration pages from 
mousetrap registration pages (see section 8.4). 

7. Perform the tests in the "Testing" section (page 1 1 ). If there are problems, go to the 
"Troubleshooting" section (page 13). 



IMPORTANT NOTE: When copying anything from an existing mousetrap to a new 
mousetrap, load the existing mousetrap file in your editor to copy data. DO NOT COPY 
BY VIEWING PAGE SOURCE IN YOUR BROWSER... SML COMMANDS WILL 
NOT BE COPIED. 
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4. Copy Files 

The first step to brewing up a mousetrap is to copy files from an existing mousetrap to the 
new mousetrap directory. If we were copying from Sex Museum, the following files 
would be copied: 

1. mmuseindex.sml 

2. mmuse hiddenl. sml 

3 . mmuse_hidden2.sml 

4. mmuse_tail.htm 

We would then rename them appropriately. For example, for Video Sex Channels, the 
frameset page might be renamed "mvscindex.sml". 

5. The Frameset Page 

Various file names need to be entered in this page to customize the mousetrap to a 
particular sales site. 

This page typically ends in "index.sml". For example, Sex Museum's frameset page has 
the filename of "mmuse_index.smF\ 

5.1.1. Warning Page 

At line 5 of the frameset page, the following needs to have the file name entered for the 
warning page: 

<$if condlgoTo vaI:.goTo='mmuse_warning.smr><$endif> 

The above setting is used for the warning page in Sex Museum. 

5.1.2. dofauItStatusMsg 

This constant needs to be set with the message desired on the bottom of the browser's 
window. The following default message was used for Sex Museum: 

defaultStatusM$g='Welcome to Sex Museum"; 

5.1.3. Hidden Pages 

Two constants must be changed to reflect the file names of the hidden files. For example, 
for the Sex Museum, the following names are used: 

hiddenl ="mmuse_hidden1 .sml"; 
hidden2="mmuse_hidden2.smr; 

Also note that the hiddenl file needs to be set in the frameset definition itself at line 84. 

5.1.4. Netscape 2 Kludge 

The defaultWarpTo constant is used because of a problem with Netscape 2. The 
following line needs to be set to the "warpTo" value in the first sales page (the page you 
come to after you click the "Enter" off the warning page). 

defaultWarpTo='mmuse_survey.sml 
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6. Warning Page 

This page contains 4 lines of JavaScript that will occur on all pages (except the 
registration pages). v 

pafent.backTo=*mmuse_softsales.smr; 
parent. warpTo='mmuse_softsales.smr'; 

window.defaultStatus=parenLdefaultStatusMsg; 
parenLloadPageO; 

The "parentbackTo" needs to be set to the page you need to go to when the user hits the 
browser's back button. The "parentwarpTo" needs to be set to the page you need to go to 
when the user tnes to go to a new location via bookmarks, history l^ortypinX new 
URL. The wmdow defaultStatus-line sets the default of the browser's staTus line to 
defaultStagusMsg value set in the frameset page. The last line runs the "loadPageO" 
method in the parent which loads a file into the hidden frame. 

All links on the warning page need to have the following line in them: 
OnClick=*pafenLclicked(this)' 

In addition, a mouse over message can be associated with the link by addine the 
following JavaScript to the link: 

OnMouseOver^retum parentsetStatusfl agree*)" 
OnMouseOut='return parenLsetStatusf}" 

The footer also needs to manually be added to the warning page and every other page in 
the mousetrap. For example, the following is used on Sex Museum: 



<#INC/d^ttp/sexmuseum/mmuse_tail.htm"#> 
<table width=610 border=0> 
<tr> 
<d> 
<ul> 

<pre><#MAC.NBHOST#x/pre></font> 
</ul> 

</td> 

</tr> 

</tab!e> 

</HTML> 

<$exit> 



The line with "d^ttp/sexmuseum/mmuse^il.htm" would change with another site For 
example, at XXX Sex Photos, the line would change to 
"d:/http/xxxsexphots/mxsp_tail.htm". 
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7. First Sales Page 

ssfs^ tur " on 0,6 waming page is 

<#MAC.visit#> 

This page has the same JavaScript as the warning page except thai the following line is 
parententerClicked=true; 

This is a variable to let other pages know that the user has clicked the "Enter" key. 

As discussed in the warning page, links to the "age verification" or registration naees 
need to have the following JavaScript: "gisnauon pages 

OnClk^'parentdirtedfthis)" 

The SML feeders need to be correct on these links as well to ensure proper statistics The 
following is a correct feeder example from Sex Museum: rustics. 1 ne 

feeder=MMUSE_sa!esJ_Lwe-<^ 

The link to the members and webmaster areas need to have the following in order to 
remove the frameset when entering these areas: 

target="Jop" OnCfick=*parentclicked(this)" 

Again, all links can make use of the mouse over events for links: 

OnMouseOver="retum parenLsetStatus('Members Enter Here 1 )* 
OnMouseOut^retum parentsetStatusC)" 
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8. Registration Page 

8.1. SML 

The SML for this page should be copied from an existing mouse trap registration page- 
<$assignval:SID.mm= , apps.xpics.com , > 

<$if cond:.free!=CHECKED cond:.ma!l!=CHECKED val:.m90=CHECKEDx$endif> 
<$if cond:.bid val:.acb=.bid><$endif> ^ncuw:u><$endrf> 

The second line above sets the default membership to the 90 Day membership. 

8.2. JavaScript 

The JavaScript for this page is different than previous pages: 

<script Ianguage="JavaScripf> 
<!- Script start 

varisSent = 0; 

parentnewWin=tnje; 

function loadfl 
{ 

^window.defaultStatus=parenLdefaultStatusMsg; 

function SubmitData( form ) 

parentnewWin=false; 
if(!isSent) 

{ 

isSent = 1; 
form.submit( ); 

} 

// Script end -> 
</script> 

8.3. Membership Codes 

The following three lines are specific to each site: 

222 wn?" 13 * 0 ' NAMEE="PARM13" VALUE="SEXM-FR' <#.free#» 
<INPUT TYPE=-radio" NAME=*PARM13' VALUE="SEXM-90" <#.m90#» 

2S^T and ." SEXM - 90 " is ***** to Sex M ^um. For example, the lines in all 
AAA bex Photos registration pages are the following: 

SI wn?. ,radi0 ' NAME= " p ARM13- VALUE="SEXRXX-FR' <#.free#» 
<INPUT 7YPE='radio- NAME='PARM13" VALUE='SEXRXX-90' <#.m90#» 
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8.4. Submit Button 

The submit button needs to look something like the following: 
<$ifcond:SID.js> 

<CE^rERxinput ^button" value=-Subrnit Information- onCfick=-SubmitData( IhisJorm )"></CENTER> 

<CEm-ER><input r/pe^submir" value^Submit lnformation"></CENTER> 
<$endif> 

The SML conditional <$if cx>nd:SID.js> needs to-be used on a mousetrap registration pages 
The SML conditional <$.f cond:MAC.user_agent LIKE "Mozilla^ is only used on non 
mousetrap registration pages. y ° n 

V 

9. The Second Sales (Survey) Page 

This page has a form on it and has JavaScript which should be copied from another 
survey page. Currently the information entered in the survey is being thrown away In 
development, we have a survey page which will store data in SQL Server We will" 
describe these two variations and their setup: 

9.1. Data Not Stored 

ssxt.tr away - en,ered *■ fo,iowi - g « — — 

1. <form name^qForm" method=post action= , mmuse_allsites.smr> 

2. <input type=hidden name="feeder" value="MMUSE_survey-<#MAC NBHOST#>"> 

3. <input type=hidden name="referer" value="<#siD.referer#>"> 

4. <input type=hidden name="bid" value="<#.bid#>"> 

The first line above needs to have the appropriate "allsites" registration page For 
example, for XXX Sex Photos, the line should have action= Wp_aIIsitel S mr. 

The second line should have the appropriate feeder. For XXX Sex Photos, it would be 
value= MXSP_ s „rvey-<#MAC.NBHOST#>». The remaining lines would not be altered. 
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9.2. Data Stored 

HTML «S "d-^ 5 ^ Cntered ^ f ° ,,0Wing HneS « «» ~ *» 
1. <form name=\,Form' method=get ^ion=-http^^ 

\ SSft-S 6 " name " fce * 1 ' value= ' MM USE_survey-<#MAC.NBHOST#>-> 

3. <input type=hidden name^referBr" value="<#SID.refere(#>"> 

4. <mput type=hidden name='bid" value='<#.bid#> , > 

5. <input type=hidden name=table_name" value="survey response^ 

6. onput type=hidden name=-redirect- value="http^.iexmuseum.com/mmuse_allsites1.smr> 

The second line should have the appropriate" feeder. For XXX Sex Photos it would be 
value="MXSP_survey-<#MAC.NBHOST#>». 

The sixth line above needs to have the foil URL of the appropriate "allsites" registration 
page For example, for XXX Sex Photos, the line should TLevalue^ 8 
nttp:/Avww.xxxsexphotos.com/mrsp_aIlsites.smI w . 

The other lines don't need to be altered. 

10. The Allsites Page 

tfiSL* ^ I" 3 ! flUed ° Ut SUFVey Page md submitted il > **y wiH be directed to the 
al s te reg IS tra Uon page Using SML conditionals, this page is responsive, depending on 
the answers to the questions in the survey page. spending on 

Nothing in this page needs to be customized for a particular site. 
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11. SoftSales Page 

br ° WSer ' S b3Ck butt0n 60111 the wamin g P a g e > ^ey will get presented 

Zt r?T "f 8 . ^ 11131 iS ^ images 111 **» P a 8 e "to than thosf in Sel 
page. The JavaScnpt in this page shows a variation over the regular sales page 

If the user presses the back button at the softsales page, they would normally go to a 
banner, page specific to the current site (see next section). However if the 1^ come 

IT TT 8 * rth0 * 3 banner 10 (a — 11 ^ntage) they may be undTl^ we 
don t want mem to go to the banners page. For this reason, the JavaScript onTeTo^les 
page is different than the regular sales page. soitsales 

if(parenLacb==") , 
{ 

P*entbackTo= 'httpi/^^^ 
ParentwarpT^ht^^ 

pafenLbackToTop=tnie; //blow away frame ' 

else 
{ 

parentbackTo="mmuse_banners.sml*; 
parenLwarpTo="mmuse_banners.smr; 

window.defauKStatus=parent.defaultStatusfvlsg- 
parenLloadPage(); 

The JavaScript above sends a user without a banner ID to CyberThrill. If they do have a 
banner ID, they go to the banners page (mmuse_banners.smf). These line coul Uhll 
dependmg on who we are directing potentially underage users to. 8 

WARNING: MAKE SURE THE FIRST LINE ON THE REGULAR SALES PAGE- 
<#MAC.visit#> 

IS NOT ON THE SOFTSALES PAGE!!! 
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12. Banners Page 

12.1. Links 

All links in the banners page need to have the following: 
Tafget^top'OnCli^'pafBnLcfickedfthis)" 

For example, a link to the ass website could look like the following: 

^J^f ^"P^/www-xpics .com/ass/ass.html?acb=acb100001-1100' Target*' Iod' 
OnClick^parenLcIickedfthis)^ a - p 

12.2. JavaScript 

This is the last stop in the mousetrap before the mousetrap is exited. We have two 
variations m the JavaScript for the banners page: 

1 * directed t0 Cyberlliri11 (or PG rated website) ^ a 

2. Ifthe :user has hit the enter button and is backing up from the survey page thevcan 
directed to the sales pages of another Xpics site with a back button X^ lfthTuser 
has backed off from the warning page (and gone to the softsales page) t^"ml? 
ducted to CyberThrill (or another PG rated website) with a back button or warp 

12.2.1. Always Directed to PG Website 

b^ttonofw^ dirCCt ** ^ t0 ^ CyberThri " site with *e back 

<SCRIPT LANGUAGE="JavaScript"> 

parentwarpTo=-ht^7/198.168.54.139/tJirill^i/ad/xpics/ri 
parent.backToTop=true; //blow away frame ' 

window.defaultStatus=parent.defaultStatusMsg- 
parentJoadPageO; 
</SCRIPT> 
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12.2.2. Not Always Directed to PG Website 

The JavaScript below will direct the user to the CyberThrill site if they have not clicked 
the enter b utton on the warning page (ie, haven't gone to the first sales page). If they have 
clicked the enter button, they will be directed to the "non-mousetrap" sal J page ofle 

oftw^ 

<SCRIPT LANGUAGE=\JavaScripr> 
jfflparententerClicked) 

parentba<*T(>=-htt^ 
parentwarpTo='http:/m 
^ parenLbackToTop=true;//blow away frame * ' 

else 
{ 

MMUSE_banners.sml-<#MAC.NBHOST#>"; 
p<™twan>Tc-'h^ 

MMUSE_banners.sml-<#MAC.NBHOST#>'; 
parenLbackToTop=true; //blow away frame ' 

window.defaultStatus=parentdefaultStatusMsg; 
parenLloadPageO; 
</SCRIPT> 
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13. Testing 

The mousetrap needs to be tested thoroughly before it is put live. After the mousetra D has 
been completely setup, testing can start. mousetrap has 

13.1. Get a Link To The Mousetrap 

Put a test banner or link (with a test banner ID) that can be clicked on to jump to the 
mousetrap frameset page. Ideally the page with this link would been another server This 

page. Also by entenng with the banner ID, we can verify that the banner ID is being 
passed to the registration page. K 

As an example, the following links were setup to test development sites in a computer 
named KAUAI: * 

Ftoutetti<K 

13.2. Test All Links 

Every link on every page needs to be tested. Make sure that the frameset is blown away 
(and without generating a new window) where the link has target="_top M in it. 

Be sure to check the links on one of the footers, the banners page, registration pages sales 
pages (including the member area and webmaster area). P 8 ' 65 

In other words, check all links on every page! 

13.3. Test Back & Warp on All Pages 

Go to each page and hit the back button to verify that the "parentbackTo" gets loaded 
Go to each page and warp out. You can do that my simply re-loading the frameset page 
When you warp, you should open a new browser window with the proper page loaded in 
it. 1 o test the next warp, you have to close the new window. 

To test the softsales page back/warp, you will have to load the frameset page both with an 
ACB banner ID and without one. If you arrive with a banner ID, you will back/warp from 
softsales to our banners page. Without a banner ID, you will bypass our banners page and 
go to a GP rated type site (like CyberThrill). FB 
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13.4. Verifying That Parameters Are Passed 

Using the link created in section 13.1, click to the frameset page (this creates a refers 

<input ^"hidden- name='PARM6' value=-httpy/kauai.sbusiness com/jump htm'> 

<mput type="hidden- name='PARM19' vahie='NEW> ~ , - uve ^ x P ,cs - sefvef6 > 
<input type^hidden' name='PARM22" value=-acb100002-60000'> 

PARM6 is the referer. In this case, we had the links to the frameset page (mentioned in 
section 13. 1) on the domain of "kauai.sbusiness.com" 8 (ment,oned m 

PARM1 8 is the feeder. The feeder should start with capital letters. If there are multiple 
mks on the sales page, the feeder should indicate which link we came from LTexamole 

S^S^T" fr0m f "^-^sLsmr page with a click onl S ' 
£>nows . The page was served up from "xpics_server6". 

PARM22 is the banner ID passed to the frameset page when it was first loaded. 
These above three parameters must be present and functional. 
13.5. Register Somebody 

Using a test credit card, register a fictitious person (ask Gene to set up a test credit card) 
Register somebody one* from every registration page, selecting different a«Zto 
Put your sbusmess email address in the registration page so Jean locateauTe^ 

^l^^ d6,ete Ush18 - AduU Ci * 

http://admin.xpics.com/xpl/admin/ 

is avai,able - ^ after relrieving -*°< 

1. Name 

2. Feeder 

3. Referrer 

4. Membership type 

5. Banner ID 

6. Credit card & expiration 
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14. Troubleshooting 

I^SZT"*" StoP ' e ,r0UbleSh00,in 6 t0 ° k 'eotaiques avairab.e to quickly isoiate 
14.1. PARM6, 18, or 22 Missing 

W btaU ftiT 6 Vl 0 ^ TV Unk 10 46 frames « W When the fiamese. 

htlpAmw^xmuseum.ajm/mmuseJndexsmPa^acblOOIX) 

" " sml? ^"">0«>^0000» parameter appended to the URL of 

14.1.1. Check The Warning Page 

With the warning page in the main frame (and using Netscape 4) right click anywhere on 
folio^ 8 PagC "* " Vi6W Frame M °" Y ° U Sh0uId ~ --thing hSe ° n 
hHp://wv W .sexm U seum.(»nVmmuse_waming^^ 

IL^** ^ T l0 ° king at inf ° f0r Ae wamin 8 P a 8 e on S « Museum. There 
should be a number after the «SID=». Then the «bid=» should be following by the test 

f^e^ 

14.1.2. Check the Sales Page URL 

Click on the Enter button and load the sales page. After the sales page is loaded rieht 
chck anywhere on the warning page (using Netscape 4), and select ''View F^eTnfo" 
You should see something like the following: ' 

httpy/www.sexmuseum.com/mmuse^^ 

As in the warning page, you should see a number after the "SID=" and the banner ID 
should be after the "bid- If this is incorrect, there is a problem on the "Inte^Hnk on 
the warning page (probably SML). 0n 
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14.1.3. Check the Sales Page Links 

With the sales page in the browser, view the source for the sales page (view frame source* 

example, in Sex Museum, the link to the "Live Shows" looks like the following: 
<A L t , ?« EF= " mmuseJivesex sml?feeder=MM USE sales 1 Live-xpics serverfiASirwmrwfin^Pk-,! 

Verify that the «feeder=" and «SII>" are present and are the correct format Also the 
OnCldc=pamntrMPd( fhK )' needs to be present. OnMouseOver and OnMouseOut are optional. 

14.1.4. Check the Registration Page 

If the above all checkout, the problem has to be in the registration page. Verify in the 
registration file the following is correct: venryintne 

<input type='hidden' name="PARM6' value="<#SID.referer#x#SID tracked#>'> 
<mput type=*hidden" name="PARM18' value="<#.feedei#>"> 
<input type='hidden" name="PARM19" value="NEW> 
<input type="hidden" name="PARM22" value="<#.bid#>'> 

14.2. Back or Warp Is Doesn't Work 

Change the frameset definition to the following: 

After re-loading the frameset page, you will see a 40 pixel window at the bottom of the 
screen. It shows the hidden2 file which has the "backTo" and "warpTo" variables You 
can verify that these variables are correct for each page. For example, from the warning 
page, these variables should be set for the softsales page. 

If the mousetrap mechanism is working properly, the small window at the bottom (the 
hidden frame) should change from the hiddenl page to the hidden2 page with each link 

S/^ri Tf!, f bUtt ° n prCSS - If U d0esn ' t ' check ** ^vaScript between the 
</title> and «</head>" and the "OnClick= . .» JavaScript on suspected link 
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15. Esoterica 
15.1. Hosts File 

When editing on a server that has multiple mirrors, the only way to guarantee getting to 
the proper u to enter the IP address instead of a URL. For example, tfyou w^uldTke to 
go to Ass on xpics_serverl", you would enter the following URL: wou,a,lketo 

http://208.21 5.61 .5/ass/massJndex.sml?acb=acb100002-60000 

Assuming you have Windows NT, an alternative to the above is to open up the "hosts" 
file. On Wmdows NT 4, you should open the following file in Notepad (if you cT't find 
the file there, just use "Find" off the "Start- button to locate the "hosts" file) 
winnt\system32\drivers\etc\hosts 

Withthe following entries in your hosts file, every time your browser requests 
a dd^ PlCS '°° m ' CXampIe ' y ° U Wi " automatica,Iv g et di "*ted to the 208.215.61.5 IP 

127.0.0.1 localhost 
208.215.61.5 www.xpics.com 
208.215.61.12 www.sexmuseum.com 
208.215.61.11 members.sexroulette.com 
208.223.222.18 www.videosexchannels.com 
208.223.222.31 www.xxxsexphotos.com 

15.2. Starting the Mousetrap On a Non-Warning Page 

The Mousetrap normally starts on the warning page. As discussed in section 5 1 1 the 
warning page filename is set in the frameset page. • » «c 

SlowlngURi:: ^ 3 m ° USetn * fr ° m ^ ^ ^ f ° r CXampIe ' y ° U WOuId enter 
http://vi^.se>cmuseum^ 

^w^ingp^ m0USetn,P ^ 831625 Page ^ SCX MUS6Um m0USetrap instead of 

This might be used when leaving backing/warping from the banners page and 
enterChcked" is true (see section 1 2.2). 
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